Aviation API
11 Graphical Aviation Forecast (GRAFOR) Charts
The Graphical Aviation Forecast Chart (GRAFOR) is a forecast issued for the NZZC FIR. The chart issued provides a forecast for various flight conditions from SFC to FL100 and grouped by regions affected. They are issued 2 times a day, valid at 00, 06, 12, and 18 (UTC).
11.1 Latest GRAFOR Set
Request the latest GRAFOR chart set.
11.1.1 API Call:
GET /aviation/chart/grafor/latest
11.1.2 Example:
This example will return links to the latest set of charts.
GET /aviation/chart/grafor/latest
11.1.3 API Response:
{
"version":"1.0",
"issue-time":"2020-03-12T02:24:44Z",
"path":"/chart/grafor/latest",
"response":[
{
"met:locator":"https://api.metservice.com/aviation/assets/grafor/grafor_120000_111953.png",
"met:product-name":"grafor",
"met:domain":"aviation",
"met:issue-time":"2020-03-11T19:53:00Z",
"met:valid-at":"2020-03-12T00:00:00Z",
"met:validity":"00"
},
{
"met:locator":"https://api.metservice.com/aviation/assets/grafor/grafor_120600_112000.png",
"met:product-name":"grafor",
"met:domain":"aviation",
"met:issue-time":"2020-03-11T20:00:00Z",
"met:valid-at":"2020-03-12T06:00:00Z",
"met:validity":"06"
},
{
"met:locator":"https://api.metservice.com/aviation/assets/grafor/grafor_121200_112001.png",
"met:product-name":"grafor",
"met:domain":"aviation",
"met:issue-time":"2020-03-11T20:01:00Z",
"met:valid-at":"2020-03-12T12:00:00Z",
"met:validity":"12"
}
]
}
11.2 Latest for a Validity
Request the latest GRAFOR chart for a specific validity.
11.2.1 API Call:
GET /aviation/chart/grafor/{validity}
11.2.2 Path Parameter:
Path Parameter | Example | Description |
---|---|---|
validity | 06 | A supported valid at time: 00, 06, 12, 18. This path parameter is Mandatory. |
11.2.3 Example:
This example will return a link to the latest grafor chart for validity 06Z.
GET /aviation/chart/grafor/06
11.2.4 API Response:
{
"version":"1.0",
"issue-time":"2018-05-23T01:08:02Z",
"path":"/chart/grafor/06",
"response":[
{
"av:grafor-validity":"06",
"met:locator":"https://api.metservice.com/assets/aviation/grafor/grafor_230600.png",
"met:product-name":"grafor",
"met:domain":"aviation",
"met:issue-time":"2018-05-22T23:40:36Z",
"met:valid-at":"2018-05-23T06:00:00Z"
}
]
}
11.3 Valid GRAFOR charts for the next n hours
Request the GRAFOR charts that will be valie in the next n hour..
11.3.1 API Call:
GET /aviation/chart/grafor/next/{n}/hours
11.3.2 Path Parameter:
Path Parameter | Example | Description |
---|---|---|
n | 06 | The number of hours into the future that the valid at time of the chart should fall within. This can be up to 24 hours. This path parameter is Mandatory. |
11.3.3 Example:
This example will return links to the charts that are valid in the next 12 hours.
GET /aviation/chart/grafor/next/12/hours
11.3.4 API Response:
{
"version": "1.0",
"issue-time": "2022-07-05T02:10:01Z",
"path": "/aviation/api/aviation/chart/grafor/next/12/hours",
"response": [
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20220704/grafor_050600_041117.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2022-07-04T11:17:00Z",
"met:valid-at": "2022-07-05T06:00:00Z",
"met:validity": "06"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20220704/grafor_050600_041122.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2022-07-04T11:22:00Z",
"met:valid-at": "2022-07-05T06:00:00Z",
"met:validity": "06"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20220704/grafor_050600_042121.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2022-07-04T21:21:00Z",
"met:valid-at": "2022-07-05T06:00:00Z",
"met:validity": "06"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20220704/grafor_051200_042118.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2022-07-04T21:18:00Z",
"met:valid-at": "2022-07-05T12:00:00Z",
"met:validity": "12"
}
]
}